Skip to main content

YupScore User Guide

Introduction​

YupScore is a collaborative estimation tool designed for agile planning sessions. It enables to estimate story points using the Fibonacci sequence, facilitating consensus-building through anonymous voting and structured discussions.

Getting Started​

For Session Hosts​

Creating a Session​

  1. Log in to YupScore at https://yupscore.web.app/host/sessions
  2. You will see active team members who have joined the refinement session

Running an Estimation Round​

  1. Start a New Round: Click the "NEW" button to begin a new estimation round

    • This resets all participant scores
    • Starts the session timer (displayed as MM:SS format)
    • Allows participants to submit new estimates

  2. Monitor Participants:

    • Watch as participants submit their scores
    • Participant cards show their name and submission status
    • A green checkmark (✓) appears when a participant has submitted their score

  3. Reveal Scores: Click the "REVEAL" button when all participants have submitted their estimates

    • Cards flip to show a checkmark
    • A modal displays the scoring outcome

Understanding Results​

When Scores Agree:

  • The modal shows "We have a score!"
  • The majority score is displayed prominently

When Scores Differ:

  • The modal shows "Different Estimates — Let's Discuss"
  • The system identifies participants with the lowest and highest estimates
  • A randomly selected question is displayed to prompt discussion
  • Use the refresh icon (↻) to switch between participants with different estimates

Rescore:

  • Once participants have explained their reasoning, start a new round to rescore
  • The rescore should ideally result in a consensus score
  1. Start Next Round: Click "NEW" again to reset scores and begin estimating the next story

For Participants​

Joining a Session​

  1. Get your URL: Obtain your unique URL
  2. Open the URL: Navigate to the URL in a web browser (ideally on your smartphone)

Submitting Estimates​

  1. Review the Story: Make sure you understand what you're estimating

  2. Select Your Estimate: Click on one of the Fibonacci numbers:

    • Available values: 0, 1, 2, 3, 5, 8, 13, 21, 34, 55, 89
    • The selected card will turn red to indicate your choice

  3. Confirm Submission:

    • A confirmation modal will appear asking: "I've understood the story and want to submit a score of [your number]"
    • Click "Yes" to submit your score
    • Click "No" to cancel and choose a different value

  4. Score Submitted:

    • Once submitted, a green checkmark (✓) appears
    • Your score buttons become semi-transparent
    • You cannot change your score after submission

After Scores Are Revealed​

  • If You Submitted: Your checkmark remains visible
  • If You Didn't Submit: A sad emoji (😢) appears, indicating you missed submitting your estimate
  • Score Submission Disabled: Once scores are revealed, you cannot submit or change your score until the next round begins

Understanding the Fibonacci Sequence​

YupScore uses the Fibonacci sequence for estimation:

ValueDescription
0Trivial or no work needed
1, 2, 3Small tasks
5, 8Medium complexity
13, 21Large tasks
34, 55, 89Very large or complex tasks. Ideally, these stories should be divided into smaller tasks.

This sequence helps teams avoid over-analysis and encourages relative sizing.

Features​

Timer​

  • Automatically starts when the host clicks "NEW"
  • Displays in MM:SS format (e.g., 05:23)
  • Resets to 00:00 when "NEW" is pressed again

Discussion Prompts​

When estimates differ significantly, YupScore provides randomised discussion questions such as:

  • "Can you walk us through what led you to your estimate?"
  • "What factors influenced your estimation?"
  • "Could you share your reasoning behind this estimate?"
  • And many more variations to keep discussions fresh

Tips for Best Results​

  1. Clear Story Descriptions: Ensure all participants understand what they're estimating
  2. Wait for All Submissions: Don't reveal scores until everyone has submitted
  3. Use Discussion Time: When estimates differ, take time to discuss and understand different perspectives
  4. Keep Sessions Focused: Use the timer to maintain momentum